home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 526-550 / disk_542 / selector / selector.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  151 lines
  1.  
  2.  
  3.                      Program Selector V3.0  (March 1991)
  4.                      ===================================
  5.  
  6.      This program is freeware, this means that you can copy it freely as long
  7. as you don't ask any more money for it than a nominal fee for copying.  If
  8. you want to distribute this program you should keep this document with it.
  9.      This program cannot be used for commercial purposes without written
  10. permission from the author.
  11.      If you have suggestions or remarks about this program, or if you find
  12. any bugs, please let me know.
  13.  
  14.      Program Selector was written to help the user assemble programs on a
  15. boot disk and start them in a userfriendly way.  It can execute any program
  16. that can be started from the CLI.
  17.  
  18.  
  19. USAGE:
  20.  
  21.      Program Selector must be started from CLI:
  22.  
  23.        "1> Selector [-h] [<filename>]"
  24.  
  25.    -h       : When this option is used the two columns will be filled evenly.
  26.    filename : This is the optional filename of the script, if you don't
  27.               specify a name 's:Selector.programs' will be read.
  28.  
  29.  
  30. FILE LIST :
  31.  
  32.     Program Selector will read a script and scan it in the following manner:
  33.  
  34. line| description                        |  example                          |
  35. ----+------------------------------------+-----------------------------------+
  36.   1 | Title                              |  Utilities                        |
  37.   2 | text for 1st gadget (max 37 char)  |  MicroEmacs 1.3                   |
  38.   3 | command sequence (max 128 char)    |  *:c/emacs                        |
  39.   4 | text for 2nd gadget                |  AmigaDOS Ed                      |
  40.   5 | 2nd command sequence               |  *:c/ed                           |
  41.   . | ...                                |  ...                              |
  42.  
  43.     The command sequence consists of any number of commands seperated by ';'.
  44. The following characters all have a special meaning, use them as the first
  45. character of a command:
  46.  
  47.     '*' : Put a '*' in front of the MAIN program if you want to multitask.
  48.           If you don't want to be able to multitask a program don't put a
  49.           '*' in front of the main program. (see RUN mode)
  50.     '#' : When there is a '#' in front of a program it will allways be
  51.           launched, even in EXEC or RUN mode (see later). (Useful for
  52.           programs who need as much memory as possible or don't return to
  53.           the CLI.)
  54.     '!' : The prompt command. The string following the '!' is no command but
  55.           a prompt. A string gadget will appear and prompt you for the
  56.           arguments to be passed to the next command. (The '!' must be the
  57.           command directly in front of the command you want the parameters to
  58.           be passed to.
  59.     '<' : Read new file list. The selector will read the file directly
  60.           following the '<' and will use this to display a new file list.
  61.           (Useful to implement some sort of sub-menus.)
  62.     '@' : If you want to use a subtitle enter a '@' instead of the command
  63.           sequence, the text will appear as a subtitle and can't be
  64.           selected.
  65.  
  66. NOTE : - Include the path to avoid problems, e.g. 'sys:Program' instead of
  67.          'Program'.  Be careful when you use spaces !
  68.  
  69.     Example script:
  70.  
  71.         UTILITIES
  72.         This program is the editor
  73.         !Edit what file ? ;*c:MicroEMACS
  74.         This is a subtitle
  75.         @
  76.         This program doesn't work with fast memory
  77.         c:Run SYS:System/NoFastMem;*:ProgramName
  78.  
  79.  
  80. GADGETS:
  81.  
  82.     There are 22 gadgets for the file text in NTSC and 32 in PAL,
  83. so you can start 22 programs if you've got a NTSC Amiga and 32 with a PAL
  84. Amiga (minus the number of subtitles).
  85.     At the top right are two invisible depth-gadgets so you can depth arrange
  86. the Selector-window.
  87.     The top left contains the RUN-EXEC-LAUNCH gadget. This gadget indicates
  88. whether the programs will be EXECuted (the Selector will disappear and return
  89. after the program has finished), RUN (the program will multitask and you
  90. can keep on using the Selector) or LAUNCHed (the Selector will disappear and
  91. stay away, the startup-sequence will continue after the Selector command).
  92.     You can force a LAUNCH by putting a '#' in front of the main program, no
  93. matter what mode you are in, the program will be LAUNCHed.
  94.  
  95.  
  96. OTHER FUNCTIONS:
  97.  
  98.     At the top right the selector will print the number of free bytes. This
  99. number will constantly update if the selector window is active.
  100.     When you click the right mouse button the Selector window will shrink to
  101. a small window the size of a title-bar. Click the right button again to get
  102. the main window back.
  103.     The small window also contains a close gadget, when you press this the
  104. execution of the startup-sequence will continue after the Selector command.
  105.     The Selector will automatically select PAL or NTSC mode.
  106.  
  107.  
  108. INSTALLATION:
  109.  
  110.     To install Program Selector on a boot disk, you should copy these files:
  111.  
  112.         c:Selector         ->  YourDisk:c
  113.         Selector.doc       ->  YourDisk:
  114.         PPMore             ->  YourDisk:c
  115.         c:Run              ->  YourDisk:c
  116.  
  117.     Then you must create in YourDisk:s the Selector.programs file. I suggest
  118. you make the two last lines of your file :
  119.  
  120.         About Program Selector
  121.         *:c/PPMore :Selector.doc
  122.  
  123.     The last thing you must do is place the command 'Selector' in your
  124. Startup-Sequence to invoke the Program Selector.
  125.  
  126.  
  127. EXAMPLE:
  128.  
  129.     To try Program Selector out, open a CLI, CD to the directory where the
  130. 'Selector' command and the example scripts are, and type:
  131.  
  132.       "1> Selector Selector.programs"
  133.  
  134.     You'll be presented with a menu from a utility disk, please note that you
  135. won't be able to execute anything, it's only an example script.  To get an
  136. example of a prompt select 'RUN' then 'TrackDisplay'.  Press the right button
  137. followed by the close gadget to quit.
  138.  
  139.  
  140.                             I hope you find this program useful,
  141.  
  142.                                                               Nico.
  143.  
  144.                     Send bug reports, suggestions, etc...
  145.  
  146.                                 Nico François
  147.                                 Corbielaan 13
  148.                                 B-3060 Bertem
  149.                                 BELGIUM
  150.  
  151.